.\" SPDX-License-Identifier: CC-BY-SA-4.0 or-later
.\" SPDX-FileCopyrightText: 2025 grommunio GmbH
.TH delivery 8gx "" "Gromox" "Gromox admin reference"
.SH Name
delivery \(em Backend for local delivery
.SH Synopsis
\fBdelivery\fP [\fB\-c\fP \fIconfig\fP]
.SH Options
.TP
\fB\-c\fP \fIconfig\fP
Read configuration directives from the given file. If this option is not
specified, /etc/gromox/delivery.cfg will be read if it exists.
.TP
\fB\-?\fP
Display option summary.
.PP
All time-based command-line options and configuration file directives are
subject to the syntax described in gromox(7), section "Duration
specifications".
.SH Configuration directives (gromox.cfg)
The following directives are recognized when reading from
/etc/gromox/gromox.cfg, or when the \fB\-c\fP option is used to specify a
custom file:
.TP
\fBdaemons_fd_limit\fP
In gromox-delivery, this is treated as an alias for lda_fd_limit.
.TP
\fBlda_fd_limit\fP
Request that the file descriptor table be at least this large. The magic value
0 indicates that the system default hard limit (rlim_max, cf. setrlimit(2))
should be used.
.br
Default: \fI0\fP
.TP
\fBoutgoing_smtp_url\fP
See gromox.cfg(5):outgoing_smtp_url.
.SH Configuration directives (delivery.cfg)
The following directives are recognized when reading from
/etc/gromox/delivery.cfg, or when the \fB\-c\fP option is used to specify a
custom file:
.TP
\fBadmin_mailbox\fP
An e-mail address where to send reports from the "net_failure" code component.
.br
Default: (empty)
.TP
\fBconfig_file_path\fP
Colon-separated list of directories which will be scanned when locating further
configuration files, especially those used by subcomponent instances. (For
example, mysql_adaptor(4gx) would be directed to look at
/etc/gromox/delivery/mysql_adaptor.cfg before /etc/gromox/mysql_adaptor.cfg.)
.br
Default: \fI/etc/gromox/delivery:/etc/gromox\fP
.TP
\fBdata_file_path\fP
Colon-separated list of directories in which static data files will be
searched.
.br
Default: \fI/usr/share/gromox/delivery\fP
.TP
\fBdequeue_max_mem\fP
Default: \fI1024M\fP
.TP
\fBdequeue_path\fP
Default: \fI/var/lib/gromox/queue\fP
.TP
\fBfree_context_num\fP
Default: \fI512\fP
.TP
\fBhost_id\fP
A unique identifier for this system. It is used for the DSN text of bounce
messages. It is used as the value for the EHLO command if and when connecting
to an SMTP service (e.g. inbox rules that do forwarding).
.br
Default: (system hostname)
.TP
\fBlda_log_file\fP
Target for log messages here. Special values: "\fI-\fP" (stderr/syslog
depending on parent PID) or "\fIsyslog\fP" are recognized.
.br
Default: \fI-\fP (auto)
.TP
\fBlda_log_level\fP
Maximum verbosity of logging. 1=crit, 2=error, 3=warn, 4=notice, 5=info, 6=debug.
.br
Default: \fI4\fP (notice)
.TP
\fBrunning_identity\fP
An unprivileged user account to switch the process to after startup.
.br
Default: \fIgromox\fP
.TP
\fBwork_threads_max\fP
The number of threads that gromox\-delivery may spawn to process incoming
messages. This number must be less-or-equal to the exmdb_local(4)
exmdb_connection_num directive to avoid rejection of messages in a message
storm.
.br
Default: \fI5\fP
.TP
\fBwork_threads_min\fP
Default: \fI1\fP
.SH See also
\fBgromox\fP(7)
